home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / dvivga1.zip / DVIVGA.DOC next >
Text File  |  1988-10-22  |  16KB  |  398 lines
  1.  
  2.                                  DVIVGA
  3.  
  4.  
  5.  
  6.                Public Domain DVI Previewer for the IBM PC
  7.  
  8.  
  9.  
  10.                               Doug McDonald
  11.          <mcdonald@uiucuxe.bitnet> | <mcdonald@uxe.cso.uiuc.edu>
  12.  
  13.  
  14.  
  15.  
  16.  DVIVGA is a TeX screen previewer for the IBM PC. It expects the name of
  17.  the .DVI file on the command line, and the extension .dvi can always
  18.  be omitted.  As illustrated below, it issues a one-line identifier
  19.  message and, if no command line arguments are given, type a UNIX-style
  20.  message.
  21.  
  22.  This driver and the associated font files are public domain. It is part
  23.  of a family written by Nelson Beebe of the University of Utah and
  24.  others. The screen previewer is an adaptation of this code by Doug
  25.  McDonald at the University of Illinois.
  26.  
  27.  
  28.  
  29.  EQUIPMENT REQUIREMENTS
  30.  
  31.  An IBM PC computer with 512K or more of memory. Alternately, a
  32.  compatible with similar specs. The screen driver needs an EGA, VGA or
  33.  MCGA graphics adapter, or a clone. A clock speed of 8MHz minimum is
  34.  essentially necessary, unless you are a very patient person. A 20 or
  35.  25MHz machine is fast enough that you will be very happy. A fast hard
  36.  disk is also necessary.
  37.  
  38.  This program will work on computers with EGAs. However, and it is a big
  39.  however, the pixels on an EGA are not square. Hence the output will be
  40.  distorted: circles come out as vertically stretched ellipses, squares
  41.  as vertically stretched rectangles, and text is a bit too high.
  42.  Nevertheless, it doesn't look bad at all and is useful.
  43.  
  44.  
  45.  
  46.  OPTIONS
  47.  
  48.  The order of command options and .DVI file name is not significant; all
  49.  switch values are accepted by this driver, but not all are really
  50.  meaningful.
  51.  
  52.  Letter case is ignored in option switches:  -A and -a are equivalent.
  53.  
  54.                 -a Implement virtual font caching. This option is
  55.                    essentially useless for this driver.
  56.  
  57.                 -d Produce debugging output on stderr if a non-zero
  58.                    value is given.  These are:
  59.  
  60.                      2 --- Display coordinates, metrics, and bitmap
  61.                            of each character.
  62.                      8 --- Display each successful file opening.
  63.                     16 --- Display each unsuccessful file opening.
  64.                     32 --- Show discarded off-page text.
  65.                     64 --- Trace virtual font caching.
  66.                    128 --- Trace character setting.
  67.  
  68.                    It is possible to combine these options by adding
  69.                    their values.
  70.  
  71.        -eVAR=value Define environment variables on command line. This
  72.                    is an alternative to placing them in the DOS
  73.                    environment.
  74.  
  75.  
  76.      -ffontsubfile Define an alternate font substitution file which is
  77.                    to be used instead of the default ones (see below).
  78.  
  79.                 -l Inhibit logging.
  80.  
  81.                 -m Reset magnification. The default for the screen
  82.                                                                   (k/2)
  83.                    driver is -m502. Useful values are int(1500*1.2     )
  84.                    from 279 to 1500. Other values will be reset to the
  85.                    nearest value in this set. Magnification values less
  86.                    than 25 are taken to be a TeX magstep parameter
  87.                    which is applied to the standard magnification for
  88.                    that device. Thus -m-0.5 will reduce the output size
  89.                    by the square root of 1.2, -m2 will increase it by 
  90.                    a factor of 1.44.
  91.  
  92.                    You may well need to use this parameter frequently;
  93.                    good values to try are 603, 502, 459, 419, 382,
  94.                    349, 318, and 289. These are equivalent to -m0.5,
  95.                    -m-0.5, -m-1, ... -m-3.5. -m382 or -m-2 gives actual
  96.                    size output using VGA on an IBM8513 monitor.
  97.                    
  98.                    Sizes smaller than 459 use substitute fonts, so that
  99.                    they may not come out looking quite perfect.
  100.  
  101.                    Read about "Batch Files" to find an easy way of
  102.                    changing sizes.
  103.  
  104.  
  105.                 -q Quiet mode.  Status displays to screen are
  106.                    suppressed, unless warning or error messages are
  107.                    issued.  This switch is a toggle. The default is
  108.                    not to display messages.
  109.  
  110.           -x#units The -x options specify the left margin of the TeX
  111.                    page on the output page in any of several units.
  112.                    Letter case is not significant in the units field,
  113.                    which must not be separated from the number by any
  114.                    space.  The number may be fractional.  For example,
  115.                    -x1.0in, -x2.54cm, -x72.27pt, and -x6.0225pc all
  116.                    specify a one-inch left margin. Negative values are
  117.                    permissible, and may be used to shift the output
  118.                    page left (possibly truncating it on the left) in
  119.                    order to display a wide TeX page.
  120.  
  121.                    The units field is mandatory, and may be one of
  122.  
  123.                            big point (1in = 72bp)
  124.                            cicero (1cc = 12dd)
  125.                            centimeter (1in = 2.54cm)
  126.                            didot point (1157dd = 1238pt)
  127.                            inch
  128.                            millimeter (10mm = 1cm)
  129.                            pica (1pc = 12pt)
  130.                            point (72.27pt = 1in)
  131.                            scaled point (65536sp = 1pt)
  132.  
  133.           -y#units This is just like -x except that it is for the top
  134.                    margin.
  135.  
  136.                    Because the normal defaults waste screen space, the
  137.                    defaults for the screen driver have both been set to
  138.                    zero. If you wish to get the correct margins and
  139.                    size, try -x1.in -y1.in -m382 for DVIVGA.
  140.  
  141.  
  142.  
  143.  FONT SUBSTITUTION
  144.  
  145.  If no -ffontsubfile option is given, and font substitution is required,
  146.  if the current .DVI file is  foo.dvi, then the files  foo.sub,
  147.  texfonts.sub, and TEXINPUTS\texfonts.sub will be tried in order.  The
  148.  first two will be found on the current directory, and the last is the
  149.  default given in the environment string TEXINPUTS.  The -f option
  150.  allows all of these to be overridden. It is essentially necessary to
  151.  have this file if you use a magnification smaller than the default for
  152.  DVIVGA. A copy of a suitable one is supplied.
  153.  
  154.  Font substitution lines have the form:
  155.  
  156.  
  157.              oldname.oldmag      subname.submag   % comment
  158.              oldname oldmag      subname submag   % comment
  159.              oldname             subname          % comment
  160.  
  161.  Examples are:
  162.  
  163. ----------
  164.  
  165.  % These provide replacements for some LaTeX invisible fonts:
  166.  icmr10 1500     ->      cmr10 1500      % comment
  167.  icmr10.1500     ->      cmr10.1500      % comment
  168.  icmssb8         ->      cmssb8          % comment
  169.  
  170. ----------
  171.  
  172.  
  173.  The first two forms request substitution of a particular font and
  174.  magnification. The third form substitutes an entire font family; the
  175.  closest available magnification to the required one will be used.  Any
  176.  dots in the non-comment portion will be converted to spaces, and
  177.  therefore, cannot be part of a name field.
  178.  
  179.  The first matching substitution will be selected, so
  180.  magnification-specific substitutions should be given first, before
  181.  family substitutions.
  182.  
  183.  Comments are introduced by percent and continue to end-of-line, just as
  184.  for TeX. One whitespace character is equivalent to any amount of
  185.  whitespace. Whitespace and comments are optional.
  186.  
  187.  
  188.  
  189.  SCREEN CONTROL
  190.  
  191.  DVIVGA supports interactive viewing of the TeX output. Here is the
  192.  current command list. Input is immediate; no terminating carriage
  193.  return is necessary, except for the number command to go to a
  194.  particular page.
  195.  
  196.  uparrow downarrow Move the view of the current page up or down. These
  197.                    commands do not require recalculating the screen
  198.